Converts any uppercase characters in a text string into their lowercase equivalents.

void LowercaseText (
    Ptr textPtr, 
    SInt16 len, 
    ScriptCode script
);

Parameter descriptions

textPtr

A pointer to the text string to be converted.

len

The number of bytes in the text string. The text string can be up to 32 KB in length.

script

The script code for the script system whose resources are used to determine the results of converting characters.

The conversion uses tables in the string-manipulation ('itl2') resource of the script specified by the value of the script parameter. You can specify smSystemScript to use the system script and smCurrentScript to use the script of the current font in the current graphics port.

DISCUSSION

LowercaseText traverses the characters starting at the address specified by textPtr and continues for the number of characters specified in len. It converts any uppercase characters in the text into lowercase.

If LowercaseText cannot access the specified resource, it generates an error code and does not modify the string. You need to call the ResError function to determine which, if any, error occurred.

SPECIAL CONSIDERATIONS

LowercaseText may move memory; your application should not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)